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COPYRIGHT NOTICE 



All rights c«f«rv«d. Ho par* of this manual may be reproduced, 
copied, or transmitted in any fora without prior written permission 
fro* Burke & Burke. 

This entire manual, any acccompanying hardware or computer 
programs, and any accompanying information storage madia constitute 
a PRODUCT of Burke and Burke. The PRODUCT ia supplied for the 
personal use of the purchaser. Burke * Burke expressly prohibits 
reproduction of this manual , the accompanying computer programs* and 
the printed circuit artwork. 

Burke * Burke expressly requires , as a condition of providing 
this PRODUCT and the associated LIMITED WARRANTY to the PURCHASER, 
that one copy of the PRODUCT be purchased from Burke 6 Burke for 
every copy used. 

Burke t Burke does not in any way transfer ownership of any 
computer programs to the PURCHASER. The PURCHASER is granted a 
limited license to use Burke « Burke computer programs distributed 
with the product/ but only on a single computer. 

LIMITED WARRANTY 

Burke * Burke warrants the PRODUCT against defects in material or 
workmanship for a period of ninety (90) days from the date of purchase 
by the original owner. This warranty is limited to repair or replacement 
of PRODUCT which proves defective during this period, at the sole expense 
and discretion of Burke f, Burke. This warranty specifically excludes 
software defects and defects caused by negligence, abuse, accident, or 
tampering. 

DISCLAIMER. 

Every effort has been made to ensure the accuracy of this manual 
and the quality of the PRODUCT it describes. Burke & Burke makes 
no warranties, whether expressed, statutory, or implied, of any kind 
whatsoever, as to the merchantability of the PRODUCT or, it's fitness 
for a particular use, except as set forth above as the- LIMITED WARRANTY. 

Burke « Burke does not assume any liability for any damages, whether 
special. Indirect, or consequential, resulting from the use of the 
PRODUCT. The PRODUCT is sold on an AS-IS basis. 



E Z Ge n 



Syntax: 



«iq«n foptsl file 



Function: edit on* or nor* OS9 nodules or data block* contained 
in a specified file. 



fil* Th« nan* of th* fil* to b* edited. 

opt* Any combination of th* following option* may b* u**d 
to Modify th* operation of BZO*nt 

_? _d -f -i -k -* -o 

Th* operation of individual option* 1* *xpl*in*d below. 
Option* can b* run together (e.g. -ru i* equivalent to 
— r -u) . 



Option*! 
-? 



-f 

-i 
-k 



Display option* si 



»ry nessage. 



Descriptive nod*. This option c*u**a SZG*n to display 
status information and interactive prompts. 

P*mit fragn*nt*d output fil*. 

Ho input — cr*at* output fil* inm*diat*ly. 

Do not mov* or chang* th* sis* of th* output fil*. 

Manual mod* — do not abort *ft*r command errors. 

Do not g*n*r*t* an output fil*. 



Commands i 



$cmd 



Display a list of th* sis*/ approximat* loading 
off**t# and nam* of each module in th* f ll*.- Th* 
loading of f**t is us*d only with boot fll*s.< ■ It 
indicat** what th* modul*'s approximat* memory 
off**t would b* if th* fil* w*r* booted. This 
can be used as an aid in arranging th* boot fil* 
to fore* modulo* to particular offsets. 



Fork shell and execute 



tnd 'end' 



Display name and sis* of modul* at currant moduli 
pointer. Th* six* is displayed in hexadecimal. 



* Traat entlrt Input Una at a connint . 

b Nov* modul* pointer to *nd of ttlm. 

c x z Chang* valu* of byt* at offset ' x* in currant nodula 
to 'I'. THIS COMMAND DOCS NOT UPDATE THE MODULE CRC. 

c x y z Chang* valu* of byt* at offset *x* in currant module 
from *y* to '*'. An arror is generated if th* byt* 
does not natch 'y*. THIS COMMAND DOES NOT UPDATE the 
MODULE CRC. 

d Dalata currant module from f 11a and sat modul a pointar 
to th* n*xt module. 

f Display name of file being edited. 

g nam* Gat avodula from memory. Tha spaclflad module is cop i ad 
froai memory to tha workfile* at tha location spacifiad 
by th* modul* pointar. Tha modul* pointer is movad to 
tha cop i ad modul*. 

h Add modula header, modul* nama and CRC to data block 

at currant modula pointar position. This command will 
convert a block of data into an OS* modula. On* 
application of this coamand is to convart an image of 
an RS— DOS binary fila to a format th* can b* *x**)ln*d 
by an OS9 disasa«mbl*r. 

i path Znsart contsnts of fila 'path* bafor* currant module* 
and mov* modul* pointar to first insartad modula or 
data block. 

1 nam* Nov* modul* pointer to sp*cifi*d modul* or data block. 

m x Display tha hax/ASCXI data stored at tha 16 consecutive 
module offsets* beginning at offset *x*. 

m x y Display the hex/ASCXX data stored at the range of module 
offsets beginning at offset *x" and ending at offset *y'. 

n Mov* module -pointer to next module or data block. 

p path Patch current module using data in fila 'path*. The 
data in 'path' must be stored in either Burke 4 Burke 
PATCH file format or RS-DOS BINARY fila format. Tha 
module CRC is corrected automatically. 

q Create output fil* and quit. 

r name Change the name of the current modul*. If the new nama 
is longer than tha old name* th* modula is extended and 
the new name is placed at the end of the module. Th* 
nodule CRC is corrected automatically. 

r n x Change a name stored In the currant module. Th* 16-bit 
valu* stored at module offset *x* is used as the modul* 
offset to the n«M string. Th* imm is chang*d to 'n' 



using the usual R- command rules. 

s Savt currant module to a disk file. The file will b« 
stored in the current execution directory. The name 
of the file will be the same as the module name. 

s path Save current module to a specified disk file. 

t Hove module pointer to beginning of file. 

u path Update the current module using the) module(s) In the 
file 'path*. The current module Is deleted/ and the 
contents of 'path* are inserted in its place. 

v Correct CRC * header parity of current nodule. This 
command is not allowed on data blocks. 

x n Extend current module by *n* bytes. Bytes are added 
at the end of the module/ and the CRC is corrected 
automat i ca 1 ly . 

y Recalculate the sice and offset of each module in the 
file. Use this command after modifying special data 
such as the module sise in an OS9 module header. 



EZOen is used to modify a file containing one or more OS* 
modules. BZOen commands will addr delete/ replace/ patch < 
verify/ or store the modules contained in the specified 
file. 

Two special file names are recognised by EZOen. If the 
name of the file is OS»Boot/ EZOen will automatically 
update the boot information in the ID sector of the 
device where the file is stored. Files named AltBoot , 
cause an automatic update of the XT-ROH alternative boot 
information/ which Is stored in the last five bytes of th« 
2D sector. 

A blank input line or end-of file has the sense effect as 
the "0" command. 

All EZOen commands operate on a copy of the input file. 
This work file is copied to the output file when either a 
blank line or the "0" commend is entered. The output 
file will have the same name as the original input file. 

Only the first character of an EZGen command is used by 
EZOen/ so each command can be written as an entire word 
if desired. For example/ you can use "rename*' instead 
of -r" if you like. 

The EZOen utility normally aborts when an error occurs. 
If a command is prefixed with "-"/ then EZOen will not 
abort even if that command generates an error. The -M 
option can also be used to disable all error aborts. 



Data or modules in the output file will be stored in 
consecutively numbered disk sectors if no options are 
given* The options change the format of the output 
file as follows i 

Options Output File Generation 



none 1) Rename input file by appending 

"El" to ita name. 

2) Create contiguous copy of work 
file with same name as original 
input file. 

3) Delete work file. 

4) Delete renamed input file. 

-f 1) Delete Input file. 

2) Rename work file to name of 
original input file. 

-k 1) Verify that work file has same 

length as input file. 

2) Copy contents of work file over 
old contents of input file. 

3) Delete work file. 

4) Delete renamed input file. 

— o 1) Exit without updating input file 

or deleting work file. 

EZGen can be used on any file. Not all files contain 
OS 9 modules < and certain special files contain both 
data and OSS modules. EXOen uses the OS9 "sync byts" 
convention to detect the start of a module. Any part 
of the file that does not follow the "sync byte" 
convention is assumed to be a data block* which ends 
when the next set of sync bytes are detected. A file 
that does not contain any sync bytes (such as a text 
file) will be treated as a single data block. 

The sync byte pattern is S87CD. 

The — F option should be used when editing files other 
than the kernel # OS9B0OT and ALTBOOT. This option 
writes a standard OS9 output file Instead of a special 
contiguous output file. 

Dse the -D and -H options when entering EXOen commands 
from the keyboard. 

EZgen automatically assigns temporary names to data 
blocks. These names have the form. 

tmp? 

The relative position of the data block is used to 
replace '?* in the name. For example* the first data 
block in a file is named *tmpO*> the fourth data block 
is named *tmp3'i and so on. 



The nanes of data blocks can change any line a data 
block is added or deleted. 

Burke & Burke PATCH format is illustrated below. All 
values are stored ae 6-bit binary codes. 

Data Record 



00 <slzel6> <offsetl6> <data bytes > 

There may be any number of data raoorda. Tha number of 
data bytes In tha record is given by tha 2 byte number* 
<«i*al6>. There must be exactly <sicel6> data bytes. 
Tha data bytas will be used to replace data in tha 
currant module be? Inn in? at tha offset ft van by tha 
2 byte number * <offsetlC>. 

BOP Record 



rr oo oo oo oo 

Exactly one BOP record must be present at tha and of tha 

file. 

Tha module header created by tha «H" command specifies a 
Module type of "6809 object code program". Tha name 
follows tha 13 byta module header immediately. EZOan 
always allocates 33 bytas for tha module name. Tha 
execution offset is set to the 1st byte of tha data 
block. A correct CRC is appended to tha data block. 



Examples t 



To install a new version of tha CC3DISK davica 
driver in tha boot file on drive /dOt 

OS9tesgen /d0/os9boot 

EXGen Version 1.08 
Copyright 1990 Burke « Burke 

*** Link to old module 

1 cc3disk 

*** Replace with new module from /dl 

u /dl/modulas/cc3disk.dr 

*** All done. 

q 

OS9* 
To change tha name of a floppy drive from "/dO" to "/fO" 
OS9tesgen /d0/os9boot 



EZGen Varsion 1.08 
Copyright 1990 Burka « Burk* 

*** Link to old eodula 

link dO 

*** Chang* nest* 

r«n«M CO 

*** All don*. 

q 

03»i 

To create * disk file containing a copy of the /ho 
bootfile's "CC3QO" module i 

OS9t*sg*n /h0/os9boot 

EXOen Varsion 1.08 
Copyright 1990 Burka 4 Burka 

*** Link to old module 

1 cc3go 

**• sava as /h0/cmds/cc3go 

s /h0/cmds/cc3go 

*** All dona. 

q 

OS9* 

To install a hard disk drlvar and davica descriptor in 
tha altarnatlva boot Cila on driva /d0» replacing tha 
existing /dd descriptor with a new version! 

089te*gen /dO/altboot 

BXGen Version 1-08 
Copyright 1990 Burke * Burke 

*»* install new {hard disk) /dd 

1 dd 

u /dO/modules/dd.dd 

«** Link to «BP module — put drlvar after it 

1 RBP 

*** Hove to next Modular since we insert "before" 

n 

*** Read in tha descriptors and driver 

i /dO/modulea/hO.dd 

i /dO/modules/bbfhdisk.dr 

**• All don*. 

q 

OS9t 
To change the step rate of floppy drive /d2 to 6ms i 
OS9tezgen /d0/os9boot 
EZGen Version 1.08 



TagXrack 

Syntax: tagtrack (opts I source_p«th track_numb«r 

Functiont Crtatts a fila containing clustara on a particular 
track/ and narks thaaa cluatara as "in— usa". 



opta Any combination of the following options atay 

. ba ussd to modify ths operation of BootPorti 

-? Display options summery message. 

-a Hark antira track as in «is«. zf thii 
option is not specified* only thoaa 
clusters that corraspond to tha 1st 
18 sactors of tha track ara Marks*]. 

aourca_path Tha nam* of tha RBF davics that contains tha 
track that you wish to "tag". 

track_number Ths (decimal) track nuabsr to ba "tagged". 



Mot SSI 



TagTrack craatas a fila called "tagOOO" in tha root 
directory of tha sourca davics. Tha segment list for 
this fila contains exactly ona entry* which includes 
all "tagged" clusters on the specified track. 

TagTrack will display a message indicating that a 
cluster is allocated to another file* but that cluster 
will still be allocated to "tagOOO". The result is a 
duplicate cluster assignment* which will be detected 
by the DCHECK utility. This allows TagTrack to ba used 
to detect files that ara resident on a particular track* 
ae follows* 

OS9ttagtrack /do 34 (look for files on track 34) 
OSSsdcheck -bp /do 



089*sap /dO/tag000 (undo the "tag" — see ZAP) 
OS9t 

The output of the DCHJECK command will include the names of 
all files that hava clusters in common with "tagOOO". 

TagTrack can be used to deleta the OS 9 kernel from a hard 
disk or floppy disk by tha ssgusnest 

OS9ttagtrack /dO 34 (assumes floppy disk) 



Copyright 1990 Burke i, Burks 

*** Link to device descriptor 

1 d2 

*** Chang* step cod* to 3 (6 ma) 

c 0014 3 

*•* Correct CRC 

v 

*•* All don*. 

q 



An *xanpl* of th* "-" praflx. In this *x«xs)l*« an 
illegal module offset i« specified in th* "C" cowMnd. 

OS9texgen foo 

KXO*n Version 1.08 
Copyright 1990 Burke fc Burke 

*** show module nam* 

foo sise-123 

*** Change at illegal offset for *x*apl* 

-c 140 3 

?(EZG*n) illegal offset 

*** Try again without the "-" 

c 140 3 

?{EZGen Illegal offset 

OS9t 

Another good use of EZOen is to add or update a nodule 
that has b**n HERGEd with other Modules (e.g. Shell), 
in this case, the output file need not be contiguous, 
so you can speed up EXOen by using the '-f * option. 

For *x*sjpl*t to add th* PARK command to your OS9 shell i 

0S9s*zg*n -f /dO/cmds/shell 

link shell 

next 

insert /d0/cmds/park 

quit 

OS9t 



2 ap 

Syntax: zag_(opts) p«th_nam« fp«th_name . . -1 



Function! R«nov«i directory entry and deallocates fila 
descriptor sector for each specified flla. 



Parameters i 

opts Any combination of the following options Bay 

ba usad to Modify tha operation of BootPortt 

— ? Display options summery message. 

path_neme Tha name of tha flla that you wish to "sap". 
Any number of pathnames May ba specified. 



Sap doas not deallocate tha sectors that were specified 
in the segment list of tha file. It simply releases the C 
directory entry and the file descriptor sector. 

One use of Zap Is to stark bad sectors In the allocation 
bit aapi so that OS9 will not attaapt to use those sectors. 
This is dona by creating a file that Includes all of the 
bad sectors , and than zap-in? the file. 

Another use of Zap is to deny OS* access to groups of 
sectors that are used by other systems (e.g. tha boot 
track). In this context, zap and TagTrack (sea TagTreck) 
perform opposite functions. 



Examplet 



To clean a file containing a bad sector from your disk* 
assuming the file is named "bedflle"i 



OS9txap /dO/bedflle 
OS9i 



Os9tdal /dO/tagOOO 
OS9: 

Us* this MquMC* only if you ar* SURE that th« data on 
track 34 is th* OS9 karnal. 

Not* that sine* TagTrack say crtati duplicat* cluster 
assignatants, it corrupts th* fil* system in a pr*dictabl* 
■tannar. Th* *ff*ct or TagTrack can b* r*v*rs*d by using 
th* cosHsandt 

OS9isap /dO/tag000 

Hh*n using th* ESC*n utility to Modify karnal data 
storsd in tagOOO, b* sur* to specify th* EZG*n "-k" 
option. 



